home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 1 / MacMania 1.toast / Games / NetHack / NH3.09XDOC < prev   
Text File  |  1991-12-30  |  7KB  |  144 lines
  1.                 Installing NetHack 3.0 Binary
  2.                 for the Macintosh   June 1990
  3.               =================================
  4.  
  5.     Please read the NetHack license (from within the game) for details
  6. on distribution and usage of Macintosh NetHack 3.0.  The NetHack license
  7. must accompany the official Macintosh NetHack 3.0 binaries contained in
  8. the file "NH3.09.hqx".  These binaries were created from the NetHack
  9. source code (updated circa June 1990) which may be obtained anonymously,
  10. by various means, from "uunet.uu.net" (192.48.96.2) under the archive
  11. directory "comp.sources.games". 
  12.  
  13.     For convenience, this installation document should also accompany
  14. the Macintosh NetHack 3.0 Binary package.
  15.  
  16.  
  17. *** Unpacking Macintosh NetHack 3.0
  18.  
  19.     To avoid problems, older versions of Macintosh NetHack should be
  20. removed from your hard disk.  This includes old "save" and "bones" files
  21. and the "NetHack prefs" file which may be in your system folder. Also,
  22. rebuilding the "desktop" file afterwards will help to avoid problems.
  23.  
  24.     You'll need approximately 2MB of hard disk space to unpack Macintosh
  25. NetHack 3.0 from the encoded archive.  A BinHex 4.0 decoder (either the
  26. application itself or the "Decode BinHex File..." feature under the
  27. "Other" menu in Stuffit) should be used to generate the Stuffit archive
  28. "NetHack3.0pl9.sit" from the text file "NH3.09.hqx".  Stuffit (v1.5.1) can
  29. then be used to extract the hierarchical folder called "Playground" from
  30. the archive.  The "Playground" folder contains 4 files/folders:
  31.  
  32. "NH3.09.doc [Installation Guide]", this document.
  33.  
  34. "Dungeon", a folder containing the application NetHack 3.0i pl9, and 17
  35.         auxiliary support files.  During and after play, the "Dungeon"
  36.         folder will also contain "save" and "bones" files.  A special
  37.         "NetHack prefs" file will be created in the "System Folder" when
  38.         the first game is played.  This is where the options chosen under
  39.         the "Set Options..." entry of the "File" menu are stored.
  40.         "Level" files are also kept in the "System Folder" during play.
  41.  
  42. "NetHack 3.0 Guidebook", a text file that serves as a primer to NetHack.
  43.         It does not contain spoilers and is a must read for beginners or
  44.         for those who want a better understanding of the game.
  45.  
  46. "Open NetHack", a special Macintosh NetHack auxiliary file that can be
  47.         used for two purposes:  (1) You can reset/erase the scoreboard
  48.         using this file by duplicating it and naming the copy "record".
  49.         If this new "record" file is placed in the "Dungeon" folder,
  50.         replacing the old "record" file already there, then the high
  51.         scores will be completely reset/erased.  (2) Double-clicking this
  52.         file will launch NetHack.
  53.  
  54.  
  55. *** Acquiring BinHex 4.0 a/o Stuffit 1.5.1
  56.  
  57.     BinHex 4.0 is available via anonymous ftp from:
  58. sumex-aim.stanford.edu (36.44.0.6)
  59. cd info-mac/util
  60. <set binary transfer mode using the "binary" command>
  61. get binhex4.bin
  62. quit
  63.  
  64.     You'll need to use a macbinary transfer of the file "binhex4.bin"
  65. from your host machine to the mac to recover the application.  Once you
  66. have BinHex 4.0 you can then return to the sumex archives and retrieve
  67. "stuffit-151-.hqx" and "stuffit-15-doc.hqx" which are BinHex 4.0 encoded.
  68. These files, which can be ascii or text transferred, are in the same
  69. directory as BinHex.
  70.  
  71.  
  72. *** Starting a game of Macintosh NetHack 3.0
  73.  
  74.     You should, of course, first read the guidebook to become familiar
  75. with NetHack.  There is a Macintosh-specific help section available from
  76. within Macintosh NetHack 3.0 that is accessed by the "?", help command.
  77.  
  78.     Macintosh NetHack was designed to run in a minimum 750kB partition
  79. under MultiFinder.  A larger partition, up to 1MB, may be desirable.
  80. For 1MB Macintoshes, running with only the Finder, it may be necessary to
  81. remove custom inits and cdevs to free up precious memory.  There should
  82. be at least 1MB of free disk space each time you play Nethack to provide
  83. room for the temporary files that Nethack creates during the game.
  84.  
  85.     The application can be launched in the traditional Macintosh ways.
  86. Additionally, the application can be launched by double-clicking on any
  87. Macintosh NetHack 3.0 auxiliary file.  If the clicked-upon auxiliary file
  88. was not a "save"-type file then you'll be presented with a startup dialog
  89. box where you can enter your character name, character preference, gender
  90. and a few other starting options.  Double-clicking on a "save"-type file
  91. bypasses this startup dialog.
  92.  
  93.     The dungeon maintainer may prefer to keep the "Dungeon" folder
  94. hidden (and perhaps invisible).  In this instance the "Open NetHack"
  95. auxiliary file can be placed anywhere on the hard drive and be used to
  96. alternatively launch the game.
  97.  
  98. *** Play under Explore-mode
  99.  
  100.     This option allows you to explore the dungeon and avoid death,
  101. unless you want to die at some point.  The price you pay is that your
  102. progress does not get recorded on the high scores list.  This mode is
  103. suggested for those interested in experimenting with difficult features
  104. of the game.  Your starting inventory will include a wand of wishing
  105. which you can use to acquire desirable magic items
  106. (i.e. "a blessed +3 long sword named Sunsword").
  107.  
  108. *** Play under Wizard/Debug-mode
  109.  
  110.     Wizard-mode gives the maintainer additional powers that should be
  111. used to debug various features of the game.  It is suggested that you
  112. not spoil your game by abusing the privileges of wizard-mode and that
  113. you reserve using this mode for legitimate debugging purposes.  Your
  114. additional commands will be documented under the "?", help command.
  115. Wizard-mode is normally inaccessible.  To enable access to wizard-mode
  116. follow these steps:
  117.  
  118.   1) Start a game.
  119.   2) Change the default name in the "Set options..." entry of the File
  120.       menu to "wizard".  Click on "Save" to record your preferences.
  121.   3) Quit this game and then start another game (not from a save file).
  122.   4) Use the name "wizard" in the starting dialog box.  A normally hidden
  123.       check box will be revealed that enables access to wizard-mode.
  124.       Select this box to play under wizard-mode.
  125.   5) Remember to change your name to something other than "wizard" and
  126.       re-save your preferences to play subsequent games in the normal way.
  127.  
  128.  
  129. *** Incompatibilities
  130.  
  131.     NetHack 3.0 should run without problems in all standard Macintosh
  132. enviroments.  It is possible that 3rd party enviroments a/o inits may
  133. cause problems, however none are known at the time of this release.
  134. We seek your help and ask that you report any conflicts you may find.
  135.  
  136.  
  137. *** Support
  138.  
  139.     Problems, comments, suggestions, thanx, etc. should be directed via
  140. e-mail to "nethack-bugs@linc.cis.upenn.edu", Subject: Mac NetHack pl9.
  141. This mail will be forwarded to the members of the Macintosh NetHack
  142. Development Team.  We've worked hard on Mac NetHack and we hope that
  143. you enjoy the game.
  144.